IRIX Base Documentation 2002 November/SGI IRIX Base Documentation 2002 November.iso/usr/share/catman/p_man/cat3/dplace.z/dplace

Text File | 2002-10-03 | 11.0 KB | 199 lines

DDDDPPPPLLLLAAAACCCCEEEE((((3333))))                                                            DDDDPPPPLLLLAAAACCCCEEEE((((3333))))



NNNNAAAAMMMMEEEE
     ddddppppllllaaaacccceeee____ffffiiiilllleeee, ddddppppllllaaaacccceeee____lllliiiinnnneeee, lllliiiibbbbddddppppllllaaaacccceeee - a library interface to dplace

CCCC SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
         vvvvooooiiiidddd ddddppppllllaaaacccceeee____ffffiiiilllleeee(((( cccchhhhaaaarrrr ****ffffiiiilllleeeennnnaaaammmmeeee))));;;;
         vvvvooooiiiidddd ddddppppllllaaaacccceeee____lllliiiinnnneeee(((( cccchhhhaaaarrrr ****lllliiiinnnneeee))));;;;



FFFFOOOORRRRTTTTRRRRAAAANNNN SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
          CCCCHHHHAAAARRRRAAAACCCCTTTTEEEERRRR****nnnn ssssttttrrrriiiinnnngggg
          CCCCAAAALLLLLLLL ddddppppllllaaaacccceeee____ffffiiiilllleeee(((( ssssttttrrrriiiinnnngggg))))
          CCCCAAAALLLLLLLL ddddppppllllaaaacccceeee____lllliiiinnnneeee(((( ssssttttrrrriiiinnnngggg))))



DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
     These library routines provide high level access to a subset of the
     memory management and control mechanisms of IRIX. Dynamic ddddppppllllaaaacccceeee(1)
     functionality is provided from within a user's program.  The first form
     takes a filename as an argument and all commands within the file are
     processed. The second form operates on a single command.  Errors are
     handled in the same way as dplace(1); the program exits and a diagnostic
     message is printed to standard error.  The library can be used with or
     without using ddddppppllllaaaacccceeee(1).


EEEEXXXXAAAAMMMMPPPPLLLLEEEE CCCCOOOODDDDEEEE
     Here is a fragment of FORTRAN code

             CCCCHHHHAAAARRRRAAAACCCCTTTTEEEERRRR****111122228888 ssss
             nnnnpppp ==== mmmmpppp____nnnnuuuummmmtttthhhhrrrreeeeaaaaddddssss(((())))
             WWWWRRRRIIIITTTTEEEE((((ssss,,,,****)))) ''''mmmmeeeemmmmoooorrrriiiieeeessss '''',,,,nnnnpppp,,,,'''' iiiinnnn ccccuuuubbbbeeee''''
             CCCCAAAALLLLLLLL ddddppppllllaaaacccceeee____lllliiiinnnneeee((((ssss))))

             WWWWRRRRIIIITTTTEEEE((((ssss,,,,****)))) ''''tttthhhhrrrreeeeaaaaddddssss '''',,,,nnnnpppp
             CCCCAAAALLLLLLLL ddddppppllllaaaacccceeee____lllliiiinnnneeee((((ssss))))

             DDDDOOOO iiii====0000,,,, nnnnpppp----1111
                 WWWWRRRRIIIITTTTEEEE((((ssss,,,,****)))) ''''rrrruuuunnnn tttthhhhrrrreeeeaaaadddd'''',,,,iiii,,,,'''' oooonnnn mmmmeeeemmmmoooorrrryyyy'''',,,,iiii
                 CCCCAAAALLLLLLLL ddddppppllllaaaacccceeee____lllliiiinnnneeee((((ssss))))
                 hhhheeeeaaaadddd ==== %%%%lllloooocccc(((( aaaa(((( 1111++++iiii****((((nnnn////nnnnpppp)))) )))) ))))
                 ttttaaaaiiiillll ==== %%%%lllloooocccc(((( aaaa(((( ((((iiii++++1111))))****((((nnnn////nnnnpppp)))) )))) ))))
                 WWWWRRRRIIIITTTTEEEE((((ssss,,,,****)))) ''''ppppllllaaaacccceeee rrrraaaannnnggggeeee'''',,,,hhhheeeeaaaadddd,,,,'''' ttttoooo'''',,,,ttttaaaaiiiillll,,,,'''' oooonnnn mmmmeeeemmmmoooorrrryyyy'''',,,,iiii
                 CCCCAAAALLLLLLLL ddddppppllllaaaacccceeee____lllliiiinnnneeee((((ssss))))
             EEEENNNNDDDD DDDDOOOO

             DDDDOOOO iiii====0000,,,, nnnnpppp----1111
                 WWWWRRRRIIIITTTTEEEE((((ssss,,,,****)))) ''''mmmmoooovvvveeee tttthhhhrrrreeeeaaaadddd'''',,,,iiii,,,,'''' ttttoooo mmmmeeeemmmmoooorrrryyyy'''',,,,nnnnpppp----1111----iiii
                 CCCCAAAALLLLLLLL ddddppppllllaaaacccceeee____lllliiiinnnneeee((((ssss))))
             EEEENNNNDDDD DDDDOOOO




                                                                        PPPPaaaaggggeeee 1111






DDDDPPPPLLLLAAAACCCCEEEE((((3333))))                                                            DDDDPPPPLLLLAAAACCCCEEEE((((3333))))



             DDDDOOOO iiii====0000,,,, nnnnpppp----1111
                 hhhheeeeaaaadddd ==== %%%%lllloooocccc(((( aaaa(((( 1111++++iiii****((((nnnn////nnnnpppp)))) )))) ))))
                 ttttaaaaiiiillll ==== %%%%lllloooocccc(((( aaaa(((( ((((iiii++++1111))))****((((nnnn////nnnnpppp)))) )))) ))))
                 WWWWRRRRIIIITTTTEEEE((((ssss,,,,****)))) ''''mmmmiiiiggggrrrraaaatttteeee rrrraaaannnnggggeeee'''',,,,hhhheeeeaaaadddd,,,,'''' ttttoooo'''',,,,ttttaaaaiiiillll,,,,'''' ttttoooo mmmmeeeemmmmoooorrrryyyy'''',,,,nnnnpppp----1111----iiii
                 CCCCAAAALLLLLLLL ddddppppllllaaaacccceeee____lllliiiinnnneeee((((ssss))))
             EEEENNNNDDDD DDDDOOOO


     and here is a C language code fragment:

          mmmmaaaaiiiinnnn(((()))){{{{ ////**** CCCC  eeeexxxxaaaammmmpppplllleeee ccccooooddddeeee ****////
          ............
              ddddppppllllaaaacccceeee____ffffiiiilllleeee((((""""iiiinnnniiiittttiiiiaaaallll____ppppllllaaaacccceeeemmmmeeeennnntttt____ffffiiiilllleeee""""))));;;;
          ............
          ............ ddddaaaattttaaaa iiiinnnniiiittttiiiiaaaalllliiiizzzzaaaattttiiiioooonnnn,,,,sssspppprrrrooooccccssss eeeettttcccc....
          ............
              ffffoooorrrr((((iiii====0000;;;;iiii<<<<nnnntttthhhhrrrreeeeaaaaddddssss;;;;iiii++++++++)))){{{{
               sssspppprrrriiiinnnnttttffff((((ccccmmmmdddd,,,,""""rrrruuuunnnn tttthhhhrrrreeeeaaaadddd %%%%dddd oooonnnn mmmmeeeemmmmoooorrrryyyy %%%%dddd\\\\nnnn"""",,,,iiii,,,,iiii////2222))));;;;
              ddddppppllllaaaacccceeee____lllliiiinnnneeee((((ccccmmmmdddd))));;;;
          ............
              sssspppprrrriiiinnnnttttffff((((ccccmmmmdddd,,,,""""mmmmiiiiggggrrrraaaatttteeee rrrraaaannnnggggeeee %%%%dddd ttttoooo %%%%dddd ttttoooo mmmmeeeemmmmoooorrrryyyy %%%%dddd\\\\nnnn""""
               ,,,,&&&&aaaa[[[[iiii****ssssiiiizzzzeeee]]]],,,,&&&&aaaa[[[[((((iiii++++1111))))ssssiiiizzzzeeee----1111]]]],,,,iiii////2222))));;;;
              ddddppppllllaaaacccceeee____lllliiiinnnneeee((((ccccmmmmdddd))));;;;
          ............
              }}}}
          }}}}

     When linking C or FORTRAN programs, the flag ----llllddddppppllllaaaacccceeee will automatically
     invokes the correct libdplace library.

FFFFIIIILLLLEEEESSSS
     ////uuuussssrrrr////lllliiiibbbb////lllliiiibbbbddddppppllllaaaacccceeee....ssssoooo

     ////uuuussssrrrr////lllliiiibbbb66664444////lllliiiibbbbddddppppllllaaaacccceeee....ssssoooo

     ////uuuussssrrrr////lllliiiibbbb33332222////lllliiiibbbbddddppppllllaaaacccceeee....ssssoooo


DDDDEEEEPPPPEEEENNNNDDDDEEEENNNNCCCCIIIIEEEESSSS
     These procedures are only available on NUMA systems. In order to avoid
     conflicts with Fortran's libmp, it is advisable to set the environment
     variable _DSM_OFF to disable libmp's NUMA functionality before running
     programs that are linked with libdplace.


BBBBUUUUGGGGSSSS
     Operations on the default policy module, such as the setting of default
     page sizes, should be done prior to an exec call to take effect. For
     example, setting the data page size with ddddppppllllaaaacccceeee____lllliiiinnnneeee or ddddppppllllaaaacccceeee____ffffiiiilllleeee from
     the program in question will not have the desired effect.





                                                                        PPPPaaaaggggeeee 2222






DDDDPPPPLLLLAAAACCCCEEEE((((3333))))                                                            DDDDPPPPLLLLAAAACCCCEEEE((((3333))))



SSSSEEEEEEEE AAAALLLLSSSSOOOO
     ddddppppllllaaaacccceeee(1), ddddppppllllaaaacccceeee(5)





















































                                                                        PPPPaaaaggggeeee 3333